home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / ranew_15.zip / RA_NEW.DOC next >
Text File  |  1992-03-22  |  18KB  |  437 lines
  1.  
  2.  
  3.  
  4.           ┌───────────────────────────────────────────────────────────────────┐
  5.           │ ▒▒▒▒  RA_NEW v1.5  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  6.           └───────────────────────────────────────────────────────────────────┘
  7.  
  8.  
  9.                             Running on RA 1.10 and above ONLY!
  10.  
  11.  
  12.  
  13.  
  14.                             RemoteAccess Fast! NEWFILES Lister
  15.  
  16.  
  17.  
  18.                                  Written by Ron Huiskes
  19.                            (c) Copyright 1990-1992 by Intersoft
  20.                                    All Rights Reserved
  21.  
  22.  
  23.  
  24.                                 Ron Huiskes / Interface
  25.                                      P.o. Box 528
  26.                                   2280 AM  Rijswijk
  27.                                    The Netherlands
  28.  
  29.  
  30.  
  31.                     +31-70-3361380 / +31-70-3361381 / +31-70-3360698
  32.                            Netmail: [2:281/506@fidonet.org]
  33.  
  34.  
  35.  
  36.  
  37.  
  38.           ┌───────────────────────────────────────────────────────────────────┐
  39.           │ ▒▒▒▒  RA_NEW v1.5  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  40.           └───────────────────────────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.          ┌────────────────────────────────────────────────────────────────────┐
  49.          │ ▒▒▒▒  Introduction   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  50.          └────────────────────────────────────────────────────────────────────┘
  51.  
  52.  
  53.  
  54.           RA_NEW is a RemoteAccess compatible door which replaces the
  55.           menu type 37 (show new files) in all your RA menus.  I have
  56.           rewritten the whole dang thing to make it look like RA_FILES
  57.           (smell like... and feel like ...).  If you haven't seen
  58.           RA_FILES yet, get RAFI_203.ZIP as soon as you can!
  59.  
  60.           Many features of RA_FILES are as of this rewrite also available
  61.           in RA_NEW.  Here's a list:
  62.  
  63.                ■    Fully configurable, great looks, all colors can be
  64.                     changed.
  65.  
  66.                ■    Users can tag files creating Generic Filedoor
  67.                     compatible tag-files (auto-load).
  68.  
  69.                ■    View total files and kilobytes on the fly.
  70.  
  71.                ■    View contents of archives (including Arc type 7 &
  72.                     Macintosh Sit) instantly.
  73.  
  74.                ■    View ASCII, ANSI, Avatar, GBS (Opus), TXT and DOC files
  75.                     instantly.
  76.  
  77.                ■    Support for FILES.RA's "list security" and "download
  78.                     security" levels.
  79.  
  80.                ■    Users can start an external transfer door from RA_NEW.
  81.                     (xfd, eft, down_tag)
  82.  
  83.                ■    Users can start an external archive viewing door from
  84.                     RA_NEW. 
  85.  
  86.                ■    Support for any screen length (10-66) on user's side.
  87.  
  88.                ■    Support for long comments.
  89.  
  90.                ■    Complete ANSI and Avatar aware (Avt/0+ including RLE
  91.                     compression).
  92.  
  93.                ■    DESQview, Multi-line, Fossil and EMS support.
  94.  
  95.                ■    RA look-a-like. Status bar works as in RA, as well as
  96.                     most of the function keys!
  97.  
  98.  
  99.  
  100.           ┌───────────────────────────────────────────────────────────────────┐
  101.           │ ▒▒▒▒  Installing... ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  102.           └───────────────────────────────────────────────────────────────────┘
  103.  
  104.  
  105.  
  106.           This version of RA_NEW needs a RA_NEW.SYS file.  No worries,
  107.           bundled with the package comes a full-screen setup utility
  108.           to maintain it (see below).  Invoke RN_SETUP from the
  109.           command-line and install RA_NEW as your standard menu type 7.
  110.  
  111.           As for the optional data field, all it needs is:
  112.  
  113.                <d:><path>RA_NEW.EXE [*M]
  114.  
  115.           The *M parameter is only necessary if you don't have enough
  116.           memory available.
  117.  
  118.  
  119.  
  120.           ┌───────────────────────────────────────────────────────────────────┐
  121.           │ ▒▒▒▒  Setup Program  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  122.           └───────────────────────────────────────────────────────────────────┘
  123.  
  124.  
  125.  
  126.           The RN_SETUP program is the main part of RA_NEW.  Here you can
  127.           change everything you like.
  128.  
  129.           Sysop name:         In this field you fill in your name exactly
  130.                               as on the registration form.  It will be used
  131.                               to calculate your registration key.
  132.  
  133.           Registration code:  The code received from us after you've
  134.                               registered, or 0 for unregistered.
  135.  
  136.           Filedoor path:      Full path and name of an external filedoor
  137.                               program.  This field reacts the same as a
  138.                               menu type 7 command, and the following
  139.                               parameters are valid:
  140.  
  141.                               *B:  Present bps-rate.
  142.                               *C:  Full path to COMMAND.COM.
  143.                               *F:  User's first name.
  144.                               *L:  User's last name.
  145.                               *M:  Swap to disk or EMS.
  146.                               *N:  Node-number.
  147.                               *P:  Comms-port used.
  148.                               *R:  User's record number.
  149.                               *T:  Time left.
  150.  
  151.                               %1:  1st parameter given on RA_NEW's start.
  152.                               %2:  2nd parameter given on....
  153.                               %3:  etc...
  154.  
  155.                               If you don't want your users to start
  156.                               filedoor from within RA_NEW just leave
  157.                               the field blank.
  158.  
  159.           Dwnload/Tag Level:  Security level required to activate the
  160.                               tagger and/or download option.
  161.  
  162.           View-door path:     Full path and name of an external archive
  163.                               viewing program.  This field reacts the same
  164.                               as a menu type 7, and the following
  165.                               parameters are valid:
  166.  
  167.                               *B:  Present bps-rate.
  168.                               *C:  Full path to COMMAND.COM.
  169.                               *F:  User's first name.
  170.                               *L:  User's last name.
  171.                               *M:  Swap to disk or EMS.
  172.                               *N:  Node-number.
  173.                               *P:  Comms-port used.
  174.                               *R:  User's record number.
  175.                               *T:  Time left.
  176.                               *9:  Full path and name to the file the user
  177.                                    wants to view. 
  178.              
  179.                               %1:  1st parameter given on RA_NEW's start
  180.                               %2:  2nd parameter given on...
  181.                               %3:  etc...
  182.  
  183.                               If you leave this field blank, the internal
  184.                               archive (and text-files) viewer will be used.
  185.  
  186.           Tag-file path:      Complete path where the tag-file should be
  187.                               created.  You can let RA_NEW create a
  188.                               tag-file in the current directory by entering
  189.                               a '.', and if you leave this field blank the
  190.                               user cannot tag at all.
  191.  
  192.           Area Name Format:   I like this since it's a bit unique. Specify
  193.                               here how you would like the file-area
  194.                               headings to be presented.  The area-number
  195.                               and area-name are available as template
  196.                               variables, and you can also choose the
  197.                               colors!
  198.  
  199.           No Description:     Should RA_NEW be unable to locate the
  200.                               description a file, it will show this field.
  201.  
  202.           Colors:             Press enter and you can change any color you
  203.                               like, or simply change everything to the
  204.                               build in default colors.
  205.  
  206.  
  207.  
  208.           ┌───────────────────────────────────────────────────────────────────┐
  209.           │ ▒▒▒▒  Long comments  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  210.           └───────────────────────────────────────────────────────────────────┘
  211.  
  212.  
  213.  
  214.           RA_NEW is able to display comments longer than 1 line.  You can
  215.           do this in two ways:
  216.  
  217.                1.   When you are editing a FILES.BBS comment, just type
  218.                     ahead with everything you want to tell about the
  219.                     program. RA_NEW will wrap the comment if it's too
  220.                     long, and continue the next line.
  221.                2.   Begin optional second, third (and so on) lines in
  222.                     files.bbs with a '+'.  These lines will also be
  223.                     displayed correctly.
  224.  
  225.           Artwork in your FILES.BBS must be preceded by a space per line.
  226.  
  227.  
  228.  
  229.           ┌───────────────────────────────────────────────────────────────────┐
  230.           │ ▒▒▒▒  Tagging        ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  231.           └───────────────────────────────────────────────────────────────────┘
  232.  
  233.  
  234.  
  235.           Tagging is available in RA_NEW by touch of a key.  No need to
  236.           enter filenames manually, or to press a certain character.
  237.  
  238.           Tagging with RA_NEW is a real pleasure. Even the numlock key
  239.           doesn't have to be toggled on to get it working.  Users can
  240.           untag already tagged files, append or overwrite existing
  241.           tag-files etc.  RA_NEW takes care of everything.
  242.  
  243.           The tag-file RA_NEW creates is a generic filedoor compatible
  244.           file used by filedoor 2.0x and above...
  245.  
  246.           The only limit to the tag system is that a user cannot tag more
  247.           than 30 files in one file area.
  248.  
  249.  
  250.  
  251.           ┌───────────────────────────────────────────────────────────────────┐
  252.           │ ▒▒▒▒  Archives       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  253.           └───────────────────────────────────────────────────────────────────┘
  254.  
  255.  
  256.  
  257.           Internal
  258.           --------
  259.  
  260.           The built-in archive viewing source code was presented by Gerhard
  261.           Hoogterp and supports the following archives:
  262.  
  263.           ARC, Arc-7, PAK, ZIP, LhArc, LHA, ARJ, HYPER, ZOO and Macintosh
  264.           SIT.
  265.  
  266.           Common self-extracting archives are also supported:
  267.  
  268.           PAK, LHA, LhArc (com & exe), ZIP and ARJ.
  269.  
  270.           ASCII, ANSI, Avatar, GBS (Opus), TXT and DOC files will be shown
  271.           to the user instantly.
  272.  
  273.  
  274.           External
  275.           --------
  276.  
  277.           If you want to start an external archive viewing door you can set
  278.           it up in RN_SETUP the same way as a normal menu type 7.  Only if
  279.           this field is blank (empty) the internal viewer will be used.
  280.  
  281.  
  282.  
  283.           ┌───────────────────────────────────────────────────────────────────┐
  284.           │ ▒▒▒▒  Behavior      ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  285.           └───────────────────────────────────────────────────────────────────┘
  286.  
  287.  
  288.  
  289.           RA_NEW checks to see which screen-length the user has chosen,
  290.           and acts accordingly.  If the screen-length is different than
  291.           the sysop's local screen (23 lines), tagging and viewing files
  292.           will look a little bit messed up on the local screen.  This is
  293.           normal, and you can trust me that the user sees everything
  294.           correct, provided he has his screen length setup correct!
  295.  
  296.           RA_NEW has smart fossil and carrier detect routines, no need
  297.           for a watch-dog or redirect program.  As soon as the
  298.           connection is broken, RA_NEW returns to the BBS, and it can
  299.           take appropriate action.
  300.  
  301.  
  302.  
  303.           ┌───────────────────────────────────────────────────────────────────┐
  304.           │ ▒▒▒▒  Disclaimer     ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  305.           └───────────────────────────────────────────────────────────────────┘
  306.  
  307.  
  308.  
  309.           RA_NEW was tested, and worked flawlessly on my system (3 lines
  310.           running under Novell).  But this does not mean that RA_NEW
  311.           will work correctly in your environment.  Please take every
  312.           precaution you think is necessary.
  313.  
  314.           RA_NEW comes with limited warranty: NONE.
  315.  
  316.           In no event shall Ron Huiskes and/or InterSoft be liable for any
  317.           damages caused by RA_NEW.  The software is supplied as-is . If
  318.           it breaks in two, you own both halves...
  319.  
  320.  
  321.  
  322.           ┌───────────────────────────────────────────────────────────────────┐
  323.           │ ▒▒▒▒  License        ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  324.           └───────────────────────────────────────────────────────────────────┘
  325.  
  326.  
  327.  
  328.           RA_NEW is distributed as -SHAREWARE-.
  329.  
  330.           RA_NEW is the copyrighted material of InterSoft & Ron Huiskes.
  331.           You may use RA_NEW for a period of 21 days on a trial basis in
  332.           order to determine it's suitability for your particular
  333.           application.  After this period you must register RA_NEW.
  334.  
  335.           Registration entitles you to use RA_NEW and any future version
  336.           of RA_NEW for as long as you wish.  InterSoft or Ron Huiskes
  337.           are in no way obligated to provide future versions of, or support
  338.           for, RA_NEW. Whether new versions will be developed will depend
  339.           on the number of registrations received for this version.
  340.  
  341.           You may not modify or otherwise reverse-engineer RA_NEW, and
  342.           RA_NEW may not be included as part of any software library
  343.           without prior written permission from InterSoft & Ron Huiskes.
  344.           If you do not agree with this license agreement you may not use
  345.           RA_NEW.
  346.  
  347.  
  348.  
  349.           ┌───────────────────────────────────────────────────────────────────┐
  350.           │ ▒▒▒▒  Registering    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  351.           └───────────────────────────────────────────────────────────────────┘
  352.  
  353.  
  354.  
  355.           The registration fee for RA_NEW is - in my opnion  - very
  356.           reasonable and affordable.
  357.  
  358.           Non-commercial: Dfl. 10,-
  359.  
  360.           Systems that qualify for this category must be physically run
  361.           from a non-commercial site.
  362.  
  363.           Commercial: Dfl. 50,-
  364.  
  365.           All other systems.
  366.  
  367.           Payments only by POSTAL MONEY ORDER, INTERNATIONAL POSTAL ORDERS,
  368.           CASH, EUROCHEQUE, GIRO or GIROTEL, payable to Ron Huiskes.
  369.           Foreign checks are NOT accepted, and everything must be written
  370.           out in Dutch currency.
  371.  
  372.           Giro-account 6031590 (Postbank NV., Amsterdam) payable to R.
  373.           Huiskes, Rijswijk.
  374.  
  375.           Print or reproduce the registration form enclosed in the RA_NEW
  376.           archive and send it, accompanied by your registration payment to:
  377.  
  378.                Interface Software            >> Interface HQ <<
  379.                P.o. Box 528                  +31-70-3361380
  380.                2280 AM Rijswijk              +31-70-3361381
  381.                The Netherlands.              +31-70-3360698
  382.  
  383.           You can also contact our US registration site for more
  384.           information:
  385.  
  386.                Scott Livingston              Phone Henge BBS
  387.                290F Brittany Farms Rd.       +1-203-826-1153
  388.                New Britain, CT 06053
  389.                USA
  390.  
  391.           After arrival of your payment and registration form, the key will
  392.           be sent to you by netmail.  If you don't have a node-number, it
  393.           will be sent to you by regular mail.
  394.  
  395.  
  396.  
  397.           ┌───────────────────────────────────────────────────────────────────┐
  398.           │ ▒▒▒▒  Credits        ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  399.           └───────────────────────────────────────────────────────────────────┘
  400.  
  401.  
  402.  
  403.           ARC              is a trademark of SEA inc.
  404.           ARJ              is a trademark of Robert K. Jung.
  405.           Avatar           is a trademark of George A. Stanislav.
  406.           Browse           is a trademark of Patrick Sjoberg.
  407.           DesqView         is a trademark of Quarterdeck Systems.
  408.           Filedoor and RFW are trademarks of Rob van.Hoeven.
  409.           HYPER            is a trademark of P.Sawatzki and Klaus P.Nischke.
  410.           LZH and LhArc    are trademarks of Yoshi.
  411.           PAK              is a trademark of NoGate Consulting.
  412.           PKPAK and PKZIP  are trademarks of PKWare Inc.
  413.           RAFM             is a trademark of Rene van.Hoorn.
  414.           RemoteAccess     is a trademark of Continental Software.
  415.           ZOO              is a trademark of Rahul Dhesi.
  416.  
  417.           The RA_NEW package is written in Turbo Pascal 6.0 and Turbo
  418.           Assembler 2.01, with help of the Turbo Debugger 2.01.  Archive
  419.           viewing routines of Gerhard Hoogterp are used as well as
  420.           InterSoft's own Communication units.
  421.  
  422.           Turbo Pascal, Turbo Assembler and Turbo Debugger are trademarks
  423.           of Borland International.
  424.  
  425.  
  426.  
  427.           In the USA the latest version of RA_NEW as well as all the other
  428.           Intersoft products are available at:
  429.  
  430.           Scott Livingston 1:142/212, 1-203-826-1153
  431.           Mike Ehlert 1:102/1001, 1-805-494-9386
  432.  
  433.           ┌───────────────────────────────────────────────────────────────────┐
  434.           │ ▒▒▒▒  RA_NEW v1.5  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  435.           └───────────────────────────────────────────────────────────────────┘
  436.  
  437.